/*
 * Copyright (c) 2013-2021 ARM Limited. All rights reserved.
 *
 * SPDX-License-Identifier: Apache-2.0
 *
 * Licensed under the Apache License, Version 2.0 (the License); you may
 * not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 * www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an AS IS BASIS, WITHOUT
 * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 *
 * ----------------------------------------------------------------------
 *
 * $Date:        15. September 2021
 * $Revision:    V2.1.0
 *
 * Project:      CMSIS-DAP Examples MCU-LINK
 * Title:        DAP_config.h CMSIS-DAP Configuration File for MCU-LINK
 *
 *---------------------------------------------------------------------------*/

#ifndef __DAP_CONFIG_H__
#define __DAP_CONFIG_H__

//**************************************************************************************************
/**
\defgroup DAP_Config_Debug_gr CMSIS-DAP Debug Unit Information
\ingroup DAP_ConfigIO_gr
@{
Provides definitions about the hardware and configuration of the Debug Unit.

This information includes:
 - Definition of Cortex-M processor parameters used in CMSIS-DAP Debug Unit.
 - Debug Unit Identification strings (Vendor, Product, Serial Number).
 - Debug Unit communication packet size.
 - Debug Access Port supported modes and settings (JTAG/SWD and SWO).
 - Optional information about a connected Target Device (for Evaluation Boards).
*/

#ifdef _RTE_
#include "RTE_Components.h"
#include CMSIS_device_header
#else
#include "device.h" // Debug Unit Cortex-M Processor Header File
#endif

#include "pin_mux.h"
#include "fsl_gpio.h"
#include "fsl_iocon.h"

#include "ser_num.h"
#include "dap_string.h"

/// Processor Clock of the Cortex-M MCU used in the Debug Unit.
/// This value is used to calculate the SWD/JTAG clock speed.
#define CPU_CLOCK 150000000U ///< Specifies the CPU Clock in Hz.

/// Number of processor cycles for I/O Port write operations.
/// This value is used to calculate the SWD/JTAG clock speed that is generated with I/O
/// Port write operations in the Debug Unit by a Cortex-M MCU. Most Cortex-M processors
/// require 2 processor cycles for a I/O Port Write operation.  If the Debug Unit uses
/// a Cortex-M0+ processor with high-speed peripheral I/O only 1 processor cycle might be
/// required.
#define IO_PORT_WRITE_CYCLES 2U ///< I/O Cycles: 2=default, 1=Cortex-M0+ fast I/0.

/// Indicate that Serial Wire Debug (SWD) communication mode is available at the Debug Access Port.
/// This information is returned by the command \ref DAP_Info as part of <b>Capabilities</b>.
#define DAP_SWD 1 ///< SWD Mode:  1 = available, 0 = not available.

/// Indicate that JTAG communication mode is available at the Debug Port.
/// This information is returned by the command \ref DAP_Info as part of <b>Capabilities</b>.
#define DAP_JTAG 1 ///< JTAG Mode: 1 = available, 0 = not available.

/// Configure maximum number of JTAG devices on the scan chain connected to the Debug Access Port.
/// This setting impacts the RAM requirements of the Debug Unit. Valid range is 1 .. 255.
#define DAP_JTAG_DEV_CNT 8U ///< Maximum number of JTAG devices on scan chain.

/// Default communication mode on the Debug Access Port.
/// Used for the command \ref DAP_Connect when Port Default mode is selected.
#define DAP_DEFAULT_PORT 1U ///< Default JTAG/SWJ Port Mode: 1 = SWD, 2 = JTAG.

/// Default communication speed on the Debug Access Port for SWD and JTAG mode.
/// Used to initialize the default SWD/JTAG clock frequency.
/// The command \ref DAP_SWJ_Clock can be used to overwrite this default setting.
#define DAP_DEFAULT_SWJ_CLOCK 5000000U ///< Default SWD/JTAG clock frequency in Hz.

/// Maximum Package Size for Command and Response data.
/// This configuration settings is used to optimize the communication performance with the
/// debugger and depends on the USB peripheral. Typical vales are 64 for Full-speed USB HID or WinUSB,
/// 1024 for High-speed USB HID and 512 for High-speed USB WinUSB.
#define DAP_PACKET_SIZE 512U ///< Specifies Packet Size in bytes.

/// Maximum Package Buffers for Command and Response data.
/// This configuration settings is used to optimize the communication performance with the
/// debugger and depends on the USB peripheral. For devices with limited RAM or USB buffer the
/// setting can be reduced (valid range is 1 .. 255).
#define DAP_PACKET_COUNT 4U ///< Specifies number of packets buffered.

/// Indicate that UART Serial Wire Output (SWO) trace is available.
/// This information is returned by the command \ref DAP_Info as part of <b>Capabilities</b>.
#define SWO_UART 1 ///< SWO UART:  1 = available, 0 = not available.

/// USART Driver instance number for the UART SWO.
#define SWO_UART_DRIVER 3 ///< USART Driver instance number (Driver_USART#).

/// Maximum SWO UART Baudrate.
/// SWO的最大波特率。
#define SWO_UART_MAX_BAUDRATE 9000000U ///< SWO UART Maximum Baudrate in Hz.

/// Indicate that Manchester Serial Wire Output (SWO) trace is available.
/// 是否支持曼彻斯特编码。
/// This information is returned by the command \ref DAP_Info as part of <b>Capabilities</b>.
#define SWO_MANCHESTER 0 ///< SWO Manchester:  1 = available, 0 = not available.

/// SWO Trace Buffer Size.
#define SWO_BUFFER_SIZE 4096U ///< SWO Trace Buffer Size in bytes (must be 2^n).

/// SWO Streaming Trace.
#define SWO_STREAM 1 ///< SWO Streaming Trace: 1 = available, 0 = not available.

/// Clock frequency of the Test Domain Timer. Timer value is returned with \ref TIMESTAMP_GET.
#define TIMESTAMP_CLOCK 150000000U ///< Timestamp clock in Hz (0 = timestamps not supported).

/// Indicate that UART Communication Port is available.
/// This information is returned by the command \ref DAP_Info as part of <b>Capabilities</b>.
#define DAP_UART 1 ///< DAP UART:  1 = available, 0 = not available.

/// USART Driver instance number for the UART Communication Port.
/// 使用的是哪个硬件串口，CMSIS-UART驱动需要。
#define DAP_UART_DRIVER 0 ///< USART Driver instance number (Driver_USART#).

/// UART Receive Buffer Size.
#define DAP_UART_RX_BUFFER_SIZE 1024U ///< Uart Receive Buffer Size in bytes (must be 2^n).

/// UART Transmit Buffer Size.
#define DAP_UART_TX_BUFFER_SIZE 1024U ///< Uart Transmit Buffer Size in bytes (must be 2^n).

/// Indicate that UART Communication via USB COM Port is available.
/// This information is returned by the command \ref DAP_Info as part of <b>Capabilities</b>.
#define DAP_UART_USB_COM_PORT 1 ///< USB COM Port:  1 = available, 0 = not available.

/// Debug Unit is connected to fixed Target Device.
/// 调试目标固定，比如直接焊在开发板上不动。
/// The Debug Unit may be part of an evaluation board and always connected to a fixed
/// known device. In this case a Device Vendor, Device Name, Board Vendor and Board Name strings
/// are stored and may be used by the debugger or IDE to configure device parameters.
#define TARGET_FIXED 0 ///< Target: 1 = known, 0 = unknown;

#define TARGET_DEVICE_VENDOR "NXP"    ///< String indicating the Silicon Vendor
#define TARGET_DEVICE_NAME "Cortex-M" ///< String indicating the Target Device
#define TARGET_BOARD_VENDOR "NXP"     ///< String indicating the Board Vendor
#define TARGET_BOARD_NAME "NXP board" ///< String indicating the Board Name

#if TARGET_FIXED != 0
#include <string.h>
static const char TargetDeviceVendor[] = TARGET_DEVICE_VENDOR;
static const char TargetDeviceName[] = TARGET_DEVICE_NAME;
static const char TargetBoardVendor[] = TARGET_BOARD_VENDOR;
static const char TargetBoardName[] = TARGET_BOARD_NAME;
#endif

/** Get Vendor Name string. 获取厂家名称。
\param str Pointer to buffer to store the string (max 60 characters).
\return String length (including terminating NULL character) or 0 (no string).
*/
__STATIC_INLINE uint8_t DAP_GetVendorString(char *str)
{
#if 0
	return return_dap_string(str, "NXP");
#else
    (void)str;
    return (0U);
#endif
}

/** Get Product Name string. 获取产品名称，keil会显示
\param str Pointer to buffer to store the string (max 60 characters).
\return String length (including terminating NULL character) or 0 (no string).
*/
__STATIC_INLINE uint8_t DAP_GetProductString(char *str)
{
#if 1
    return return_dap_string(str, "DAPLink CMSIS-DAP");
#else
    (void)str;
    return (0U);
#endif
}

/** Get Serial Number string. 获取序列号。
\param str Pointer to buffer to store the string (max 60 characters).
\return String length (including terminating NULL character) or 0 (no string).
*/
__STATIC_INLINE uint8_t DAP_GetSerNumString(char *str)
{
#if 1
    return return_dap_string(str, GetSerialNum());
#else
    uint8_t len = 0U;
    char *ser_num;

    ser_num = GetSerialNum();
    if (ser_num != NULL)
    {
        strcpy(str, ser_num);
        len = (uint8_t)(strlen(ser_num) + 1U);
    }

    return (len);
#endif
}

/** Get Target Device Vendor string.
\param str Pointer to buffer to store the string (max 60 characters).
\return String length (including terminating NULL character) or 0 (no string).
*/
__STATIC_INLINE uint8_t DAP_GetTargetDeviceVendorString(char *str)
{
#if TARGET_FIXED != 0
    uint8_t len;

    strcpy(str, TargetDeviceVendor);
    len = (uint8_t)(strlen(TargetDeviceVendor) + 1U);
    return (len);
#else
    (void)str;
    return (0U);
#endif
}

/** Get Target Device Name string.
\param str Pointer to buffer to store the string (max 60 characters).
\return String length (including terminating NULL character) or 0 (no string).
*/
__STATIC_INLINE uint8_t DAP_GetTargetDeviceNameString(char *str)
{
#if TARGET_FIXED != 0
    uint8_t len;

    strcpy(str, TargetDeviceName);
    len = (uint8_t)(strlen(TargetDeviceName) + 1U);
    return (len);
#else
    (void)str;
    return (0U);
#endif
}

/** Get Target Board Vendor string.
\param str Pointer to buffer to store the string (max 60 characters).
\return String length (including terminating NULL character) or 0 (no string).
*/
__STATIC_INLINE uint8_t DAP_GetTargetBoardVendorString(char *str)
{
#if TARGET_FIXED != 0
    uint8_t len;

    strcpy(str, TargetBoardVendor);
    len = (uint8_t)(strlen(TargetBoardVendor) + 1U);
    return (len);
#else
    (void)str;
    return (0U);
#endif
}

/** Get Target Board Name string.
\param str Pointer to buffer to store the string (max 60 characters).
\return String length (including terminating NULL character) or 0 (no string).
*/
__STATIC_INLINE uint8_t DAP_GetTargetBoardNameString(char *str)
{
#if TARGET_FIXED != 0
    uint8_t len;

    strcpy(str, TargetBoardName);
    len = (uint8_t)(strlen(TargetBoardName) + 1U);
    return (len);
#else
    (void)str;
    return (0U);
#endif
}

/** Get Product Firmware Version string.
\param str Pointer to buffer to store the string (max 60 characters).
\return String length (including terminating NULL character) or 0 (no string).
*/
__STATIC_INLINE uint8_t DAP_GetProductFirmwareVersionString(char *str)
{
    (void)str;
    return (0U);
}

///@}

//**************************************************************************************************
/**
\defgroup DAP_Config_PortIO_gr CMSIS-DAP Hardware I/O Pin Access
\ingroup DAP_ConfigIO_gr
@{

Standard I/O Pins of the CMSIS-DAP Hardware Debug Port support standard JTAG mode
and Serial Wire Debug (SWD) mode. In SWD mode only 2 pins are required to implement the debug
interface of a device. The following I/O Pins are provided:

JTAG I/O Pin                 | SWD I/O Pin          | CMSIS-DAP Hardware pin mode
---------------------------- | -------------------- | ---------------------------------------------
TCK: Test Clock              | SWCLK: Clock         | Output Push/Pull
TMS: Test Mode Select        | SWDIO: Data I/O      | Output Push/Pull; Input (for receiving data)
TDI: Test Data Input         |                      | Output Push/Pull
TDO: Test Data Output        |                      | Input
nTRST: Test Reset (optional) |                      | Output Open Drain with pull-up resistor
nRESET: Device Reset         | nRESET: Device Reset | Output Open Drain with pull-up resistor


DAP Hardware I/O Pin Access Functions
-------------------------------------
The various I/O Pins are accessed by functions that implement the Read, Write, Set, or Clear to
these I/O Pins.

For the SWDIO I/O Pin there are additional functions that are called in SWD I/O mode only.
This functions are provided to achieve faster I/O that is possible with some advanced GPIO
peripherals that can independently write/read a single I/O pin without affecting any other pins
of the same I/O port. The following SWDIO I/O Pin functions are provided:
 - \ref PIN_SWDIO_OUT_ENABLE to enable the output mode from the DAP hardware.
 - \ref PIN_SWDIO_OUT_DISABLE to enable the input mode to the DAP hardware.
 - \ref PIN_SWDIO_IN to read from the SWDIO I/O pin with utmost possible speed.
 - \ref PIN_SWDIO_OUT to write to the SWDIO I/O pin with utmost possible speed.
*/

// All pins are PIO0.
#define PIN_PIO_PORT (0U)

// Debug Port I/O Pins

// TRST Pin             	    PIO0_28 (O)
#define PIN_TRST (28U)
#define PIN_TRST_MASK (1U << PIN_TRST)

// TDI Pin             			PIO0_22 (O)
#define PIN_TDI (22U)
#define PIN_TDI_MASK (1U << PIN_TDI)

// TMS Pin                		PIO0_4 (IO)
#define PIN_TMS (4U)
#define PIN_TMS_MASK (1U << PIN_TMS)

// TCK Pin             	        PIO0_6 (O)
#define PIN_TCK (6U)
#define PIN_TCK_MASK (1U << PIN_TCK)

// RTCK Pin             	    PIO0_29 (I)
#define PIN_RTCK (29U)
#define PIN_RTCK_MASK (1U << PIN_RTCK)

// TDO Pin            			PIO0_3 (I)
// SWO = function 1 (FC3_RXD_SDA_MOSI_DATA)
#define PIN_TDO (3U)
#define PIN_TDO_MASK (1U << PIN_TDO)

// nRESET Pin                   PIO0_1 (O)
#define PIN_RESET (1U)
#define PIN_RESET_MASK (1U << PIN_RESET)

// UART Rx Pin                  PIO0_24 (I)
// function 1 (FC0_RXD_SDA_MOSI_DATA)
#define PIN_UART_RX (24U)
#define PIN_UART_RX_MASK (1U << PIN_UART_RX)

// UART Tx Pin                  PIO0_25 (O)
// function 1 (FC0_TXD_SCL_MISO_WS)
#define PIN_UART_TX (25U)
#define PIN_UART_TX_MASK (1U << PIN_UART_TX)

// TRST_DIR Pin             	PIO0_26 (O)
#define PIN_TRST_DIR (26U)
#define PIN_TRST_DIR_MASK (1U << PIN_TRST_DIR)

// TDI_DIR Pin             	    PIO0_21 (O)
#define PIN_TDI_DIR (21U)
#define PIN_TDI_DIR_MASK (1U << PIN_TDI_DIR)

// TMS_DIR Pin                	PIO0_2 (O)
#define PIN_TMS_DIR (2U)
#define PIN_TMS_DIR_MASK (1U << PIN_TMS_DIR)

// TCK_DIR Pin             	    PIO0_19 (O)
#define PIN_TCK_DIR (19U)
#define PIN_TCK_DIR_MASK (1U << PIN_TCK_DIR)

// RTCK_DIR Pin             	PIO0_30 (O)
#define PIN_RTCK_DIR (30U)
#define PIN_RTCK_DIR_MASK (1U << PIN_RTCK_DIR)

// TDO_DIR Pin            	    PIO0_7 (O)
#define PIN_TDO_DIR (7U)
#define PIN_TDO_DIR_MASK (1U << PIN_TDO_DIR)

// nRESET_DIR Pin               PIO0_17 (O)
#define PIN_RESET_DIR (17U)
#define PIN_RESET_DIR_MASK (1U << PIN_RESET_DIR)

// UART Rx_DIR Pin              PIO0_13 (O)
#define PIN_UART_RX_DIR (13U)
#define PIN_UART_RX_DIR_MASK (1U << PIN_UART_RX_DIR)

// UART Tx_DIR Pin              PIO0_14 (O)
#define PIN_UART_TX_DIR (14U)
#define PIN_UART_TX_DIR_MASK (1U << PIN_UART_TX_DIR)

// LED_CONNECTED_PIN			PIO0_10 (O)
#define LED_CONNECTED_PIN (10)
#define LED_CONNECTED_PIN_MASK (1U << LED_CONNECTED_PIN)

// LED_RUNNING_PIN				PIO0_0 (O)
#define LED_RUNNING_PIN (0)
#define LED_RUNNING_PIN_MASK (1U << LED_RUNNING_PIN)

// LED_SWD_PIN					PIO0_18 (O)
#define LED_SWD_PIN (18)
#define LED_SWD_PIN_MASK (1U << LED_SWD_PIN)

// LED_JTAG_PIN					PIO0_9 (O)
#define LED_JTAG_PIN (9)
#define LED_JTAG_PIN_MASK (1U << LED_JTAG_PIN)

// Configure DAP I/O pins ------------------------------

/** Setup JTAG I/O pins: TCK, TMS, TDI, TDO, nTRST, and nRESET.
Configures the DAP Hardware I/O pins for JTAG mode:
 - TCK, TMS, TDI, nTRST, nRESET to output mode and set to high level.
 - TDO to input mode.
*/
__STATIC_INLINE void PORT_JTAG_SETUP(void)
{
    // 电平转换器方向设成输出
    GPIO->SET[PIN_PIO_PORT] = PIN_TDI_DIR_MASK |
                              PIN_TMS_DIR_MASK |
                              PIN_TCK_DIR_MASK;

    // TDI
    GPIO->CLR[PIN_PIO_PORT] = PIN_TRST_MASK;   // 拉低
    GPIO->DIRSET[PIN_PIO_PORT] = PIN_TDI_MASK; // 输出

    // TMS
    GPIO->SET[PIN_PIO_PORT] = PIN_TMS_MASK;    // 拉高
    GPIO->DIRSET[PIN_PIO_PORT] = PIN_TMS_MASK; // 输出

    // TCK
    GPIO->SET[PIN_PIO_PORT] = PIN_TCK_MASK;    // 拉高
    GPIO->DIRSET[PIN_PIO_PORT] = PIN_TCK_MASK; // 输出

    // TDO切换成IO
    IOCON->PIO[PIN_PIO_PORT][PIN_TDO] = IOCON_FUNC0 |
                                        IOCON_SLEW_FAST |
                                        IOCON_DIGITAL_EN;
										
	GPIO->CLR[PIN_PIO_PORT] = LED_JTAG_PIN_MASK;
}

/** Setup SWD I/O pins: SWCLK, SWDIO, and nRESET.
Configures the DAP Hardware I/O pins for Serial Wire Debug (SWD) mode:
 - SWCLK, SWDIO, nRESET to output mode and set to default high level.
 - TDI, nTRST to HighZ mode (pins are unused in SWD mode).
*/
__STATIC_INLINE void PORT_SWD_SETUP(void)
{
    // 电平转换器方向设成输出
    GPIO->SET[PIN_PIO_PORT] = PIN_TMS_DIR_MASK |
                              PIN_TCK_DIR_MASK;

    // TMS
    GPIO->SET[PIN_PIO_PORT] = PIN_TMS_MASK;    // 拉高
    GPIO->DIRSET[PIN_PIO_PORT] = PIN_TMS_MASK; // 输出

    // TCK
    GPIO->SET[PIN_PIO_PORT] = PIN_TCK_MASK;    // 拉高
    GPIO->DIRSET[PIN_PIO_PORT] = PIN_TCK_MASK; // 输出
	
	GPIO->CLR[PIN_PIO_PORT] = LED_SWD_PIN_MASK;
}

/** Disable JTAG/SWD I/O Pins.
Disables the DAP Hardware I/O pins which configures:
 - TCK/SWCLK, TMS/SWDIO, TDI, TDO, nTRST, nRESET to High-Z mode.
*/
__STATIC_INLINE void PORT_OFF(void)
{
    // IO方向设成输入
    GPIO->DIRCLR[PIN_PIO_PORT] = PIN_TRST_MASK |
                                 PIN_TDI_MASK |
                                 PIN_TMS_MASK |
                                 PIN_TCK_MASK |
                                 PIN_RTCK_MASK |
                                 PIN_TDO_MASK |
                                 PIN_RESET_MASK;
    
    // 转换器方向设成输入
    GPIO->CLR[PIN_PIO_PORT] = PIN_TRST_DIR_MASK |
                              PIN_TDI_DIR_MASK |
                              PIN_TMS_DIR_MASK |
                              PIN_TCK_DIR_MASK |
                              PIN_RTCK_DIR_MASK |
                              PIN_TDO_DIR_MASK |
                              PIN_RESET_DIR_MASK;

    // TDO切换成SWO
    IOCON->PIO[PIN_PIO_PORT][PIN_TDO] = IOCON_FUNC1 |
                                        IOCON_SLEW_FAST |
                                        IOCON_DIGITAL_EN;
										
	GPIO->SET[PIN_PIO_PORT] = LED_JTAG_PIN_MASK;
	GPIO->SET[PIN_PIO_PORT] = LED_SWD_PIN_MASK;
}

// SWCLK/TCK I/O pin -------------------------------------

/** SWCLK/TCK I/O pin: Get Input.
\return Current status of the SWCLK/TCK DAP hardware I/O pin.
*/
__STATIC_FORCEINLINE uint32_t PIN_SWCLK_TCK_IN(void)
{
    // 读取TCK引脚
    return GPIO->B[PIN_PIO_PORT][PIN_TCK];
}

/** SWCLK/TCK I/O pin: Set Output to High.
Set the SWCLK/TCK DAP hardware I/O pin to high level.
*/
__STATIC_FORCEINLINE void PIN_SWCLK_TCK_SET(void)
{
    // 拉高TCK引脚
    GPIO->B[PIN_PIO_PORT][PIN_TCK] = 1;
}

/** SWCLK/TCK I/O pin: Set Output to Low.
Set the SWCLK/TCK DAP hardware I/O pin to low level.
*/
__STATIC_FORCEINLINE void PIN_SWCLK_TCK_CLR(void)
{
    // 拉低TCK引脚
    GPIO->B[PIN_PIO_PORT][PIN_TCK] = 0;
}

// SWDIO/TMS Pin I/O --------------------------------------

/** SWDIO/TMS I/O pin: Get Input.
\return Current status of the SWDIO/TMS DAP hardware I/O pin.
*/
__STATIC_FORCEINLINE uint32_t PIN_SWDIO_TMS_IN(void)
{
    // 读取TMS引脚
    return GPIO->B[PIN_PIO_PORT][PIN_TMS];
}

/** SWDIO/TMS I/O pin: Set Output to High.
Set the SWDIO/TMS DAP hardware I/O pin to high level.
*/
__STATIC_FORCEINLINE void PIN_SWDIO_TMS_SET(void)
{
    // 拉高TMS引脚
    GPIO->SET[PIN_PIO_PORT] = PIN_TMS_MASK;
}

/** SWDIO/TMS I/O pin: Set Output to Low.
Set the SWDIO/TMS DAP hardware I/O pin to low level.
*/
__STATIC_FORCEINLINE void PIN_SWDIO_TMS_CLR(void)
{
    // 拉低TMS引脚
    GPIO->CLR[PIN_PIO_PORT] = PIN_TMS_MASK;
}

/** SWDIO I/O pin: Get Input (used in SWD mode only).
\return Current status of the SWDIO DAP hardware I/O pin.
*/
__STATIC_FORCEINLINE uint32_t PIN_SWDIO_IN(void)
{
    // 读取TMS引脚
    return GPIO->B[PIN_PIO_PORT][PIN_TMS];
}

/** SWDIO I/O pin: Set Output (used in SWD mode only).
\param bit Output value for the SWDIO DAP hardware I/O pin.
*/
__STATIC_FORCEINLINE void PIN_SWDIO_OUT(uint32_t bit)
{
    // 输出TMS引脚
    GPIO->B[PIN_PIO_PORT][PIN_TMS] = bit;
}

/** SWDIO I/O pin: Switch to Output mode (used in SWD mode only).
Configure the SWDIO DAP hardware I/O pin to output mode. This function is
called prior \ref PIN_SWDIO_OUT function calls.
*/
__STATIC_FORCEINLINE void PIN_SWDIO_OUT_ENABLE(void)
{
    // 电平转换器方向设成输出
    GPIO->SET[PIN_PIO_PORT] = PIN_TMS_DIR_MASK; // 输出
    // 使能TMS引脚输出
    GPIO->DIRSET[PIN_PIO_PORT] = PIN_TMS_MASK;  // 输出
}

/** SWDIO I/O pin: Switch to Input mode (used in SWD mode only).
Configure the SWDIO DAP hardware I/O pin to input mode. This function is
called prior \ref PIN_SWDIO_IN function calls.
*/
__STATIC_FORCEINLINE void PIN_SWDIO_OUT_DISABLE(void)
{
    // 使能TMS引脚输入
    GPIO->DIRCLR[PIN_PIO_PORT] = PIN_TMS_MASK;  // 输入
    // 电平转换器方向设成输入
    GPIO->CLR[PIN_PIO_PORT] = PIN_TMS_DIR_MASK; // 输入
}

// TDI Pin I/O ---------------------------------------------

/** TDI I/O pin: Get Input.
\return Current status of the TDI DAP hardware I/O pin.
*/
__STATIC_FORCEINLINE uint32_t PIN_TDI_IN(void)
{
    // 读取TDI引脚
    return GPIO->B[PIN_PIO_PORT][PIN_TDI];
}

/** TDI I/O pin: Set Output.
\param bit Output value for the TDI DAP hardware I/O pin.
*/
__STATIC_FORCEINLINE void PIN_TDI_OUT(uint32_t bit)
{
    // 输出TDI引脚
    GPIO->B[PIN_PIO_PORT][PIN_TDI] = bit;
}

// TDO Pin I/O ---------------------------------------------

/** TDO I/O pin: Get Input.
\return Current status of the TDO DAP hardware I/O pin.
*/
__STATIC_FORCEINLINE uint32_t PIN_TDO_IN(void)
{
    // 读取TDO引脚
    return GPIO->B[PIN_PIO_PORT][PIN_TDO];
}

// nTRST Pin I/O -------------------------------------------

/** nTRST I/O pin: Get Input.
\return Current status of the nTRST DAP hardware I/O pin.
*/
__STATIC_FORCEINLINE uint32_t PIN_nTRST_IN(void)
{
    return GPIO->B[PIN_PIO_PORT][PIN_TRST];
}

/** nTRST I/O pin: Set Output.
\param bit JTAG TRST Test Reset pin status:
           - 0: issue a JTAG TRST Test Reset.
           - 1: release JTAG TRST Test Reset.
*/
__STATIC_FORCEINLINE void PIN_nTRST_OUT(uint32_t bit)
{
    if (bit > 0) // 不需要输出
    {
        GPIO->B[PIN_PIO_PORT][PIN_TRST] = 1;         // 写1
        GPIO->DIRCLR[PIN_PIO_PORT] = PIN_TRST_MASK;  // 输入
        GPIO->SET[PIN_PIO_PORT] = PIN_TRST_DIR_MASK; // 输入
    }
    else // 需要输出
    {
        GPIO->SET[PIN_PIO_PORT] = PIN_TRST_DIR_MASK; // 输出
        GPIO->DIRSET[PIN_PIO_PORT] = PIN_TRST_MASK;  // 输出
        GPIO->B[PIN_PIO_PORT][PIN_TRST] = 0;         // 写0
    }
}

// nRESET Pin I/O------------------------------------------

/** nRESET I/O pin: Get Input.
\return Current status of the nRESET DAP hardware I/O pin.
*/
__STATIC_FORCEINLINE uint32_t PIN_nRESET_IN(void)
{
    return GPIO->B[PIN_PIO_PORT][PIN_RESET];
}

/** nRESET I/O pin: Set Output.
\param bit target device hardware reset pin status:
           - 0: issue a device hardware reset.
           - 1: release device hardware reset.
*/
__STATIC_FORCEINLINE void PIN_nRESET_OUT(uint32_t bit)
{
    if (bit > 0) // 不需要输出
    {
        GPIO->B[PIN_PIO_PORT][PIN_RESET] = 1;         // 写1
        GPIO->DIRCLR[PIN_PIO_PORT] = PIN_RESET_MASK;  // 输入
        GPIO->SET[PIN_PIO_PORT] = PIN_RESET_DIR_MASK; // 输入
    }
    else // 需要输出
    {
        GPIO->SET[PIN_PIO_PORT] = PIN_RESET_DIR_MASK; // 输出
        GPIO->DIRSET[PIN_PIO_PORT] = PIN_RESET_MASK;  // 输出
        GPIO->B[PIN_PIO_PORT][PIN_RESET] = 0;         // 写0
    }
}

///@}

//**************************************************************************************************
/**
\defgroup DAP_Config_LEDs_gr CMSIS-DAP Hardware Status LEDs
\ingroup DAP_ConfigIO_gr
@{

CMSIS-DAP Hardware may provide LEDs that indicate the status of the CMSIS-DAP Debug Unit.

It is recommended to provide the following LEDs for status indication:
 - Connect LED: is active when the DAP hardware is connected to a debugger.
 - Running LED: is active when the debugger has put the target device into running state.
*/

/** Debug Unit: Set status of Connected LED.
\param bit status of the Connect LED.
           - 1: Connect LED ON: debugger is connected to CMSIS-DAP Debug Unit.
           - 0: Connect LED OFF: debugger is not connected to CMSIS-DAP Debug Unit.
*/
__STATIC_INLINE void LED_CONNECTED_OUT(uint32_t bit)
{
    GPIO->B[PIN_PIO_PORT][LED_CONNECTED_PIN] = !(bit > 0);
}

/** Debug Unit: Set status Target Running LED.
\param bit status of the Target Running LED.
           - 1: Target Running LED ON: program execution in target started.
           - 0: Target Running LED OFF: program execution in target stopped.
*/
__STATIC_INLINE void LED_RUNNING_OUT(uint32_t bit)
{
    GPIO->B[PIN_PIO_PORT][LED_RUNNING_PIN] = !(bit > 0);
}

///@}

//**************************************************************************************************
/**
\defgroup DAP_Config_Timestamp_gr CMSIS-DAP Timestamp
\ingroup DAP_ConfigIO_gr
@{
Access function for Test Domain Timer.

The value of the Test Domain Timer in the Debug Unit is returned by the function \ref TIMESTAMP_GET. By
default, the DWT timer is used.  The frequency of this timer is configured with \ref TIMESTAMP_CLOCK.

*/

/** Get timestamp of Test Domain Timer.
\return Current timestamp value.
*/
__STATIC_INLINE uint32_t TIMESTAMP_GET(void)
{
    return (DWT->CYCCNT);
}

///@}

//**************************************************************************************************
/**
\defgroup DAP_Config_Initialization_gr CMSIS-DAP Initialization
\ingroup DAP_ConfigIO_gr
@{

CMSIS-DAP Hardware I/O and LED Pins are initialized with the function \ref DAP_SETUP.
*/

/** Setup of the Debug Unit I/O pins and LEDs (called when Debug Unit is initialized).
This function performs the initialization of the CMSIS-DAP Hardware I/O Pins and the
Status LEDs. In detail the operation of Hardware I/O and LED pins are enabled and set:
 - I/O clock system enabled.
 - all I/O pins: input buffer enabled, output pins are set to HighZ mode.
 - for nTRST, nRESET a weak pull-up (if available) is enabled.
 - LED output pins are enabled and LEDs are turned off.
*/
__STATIC_INLINE void DAP_SETUP(void)
{
    // Configure pins.
    static const iocon_group_t kPinConfigs[] = {
        {.port = PIN_PIO_PORT, .pin = PIN_TRST, .modefunc = IOCON_FUNC0 | IOCON_DIGITAL_EN | IOCON_SLEW_FAST},
        {.port = PIN_PIO_PORT, .pin = PIN_TDI, .modefunc = IOCON_FUNC0 | IOCON_DIGITAL_EN | IOCON_SLEW_FAST},
        {.port = PIN_PIO_PORT, .pin = PIN_TMS, .modefunc = IOCON_FUNC0 | IOCON_DIGITAL_EN | IOCON_SLEW_FAST},
        {.port = PIN_PIO_PORT, .pin = PIN_TCK, .modefunc = IOCON_FUNC0 | IOCON_DIGITAL_EN | IOCON_SLEW_FAST},
        {.port = PIN_PIO_PORT, .pin = PIN_RTCK, .modefunc = IOCON_FUNC0 | IOCON_DIGITAL_EN | IOCON_SLEW_FAST},
        {.port = PIN_PIO_PORT, .pin = PIN_TDO, .modefunc = IOCON_FUNC0 | IOCON_DIGITAL_EN | IOCON_SLEW_FAST},
        {.port = PIN_PIO_PORT, .pin = PIN_RESET, .modefunc = IOCON_FUNC0 | IOCON_DIGITAL_EN | IOCON_SLEW_FAST},

        {.port = PIN_PIO_PORT, .pin = PIN_TRST_DIR, .modefunc = IOCON_FUNC0 | IOCON_DIGITAL_EN | IOCON_SLEW_FAST},
        {.port = PIN_PIO_PORT, .pin = PIN_TDI_DIR, .modefunc = IOCON_FUNC0 | IOCON_DIGITAL_EN | IOCON_SLEW_FAST},
        {.port = PIN_PIO_PORT, .pin = PIN_TMS_DIR, .modefunc = IOCON_FUNC0 | IOCON_DIGITAL_EN | IOCON_SLEW_FAST},
        {.port = PIN_PIO_PORT, .pin = PIN_TCK_DIR, .modefunc = IOCON_FUNC0 | IOCON_DIGITAL_EN | IOCON_SLEW_FAST},
        {.port = PIN_PIO_PORT, .pin = PIN_RTCK_DIR, .modefunc = IOCON_FUNC0 | IOCON_DIGITAL_EN | IOCON_SLEW_FAST},
        {.port = PIN_PIO_PORT, .pin = PIN_TDO_DIR, .modefunc = IOCON_FUNC0 | IOCON_DIGITAL_EN | IOCON_SLEW_FAST},
        {.port = PIN_PIO_PORT, .pin = PIN_RESET_DIR, .modefunc = IOCON_FUNC0 | IOCON_DIGITAL_EN | IOCON_SLEW_FAST},

        {.port = PIN_PIO_PORT, .pin = LED_CONNECTED_PIN, .modefunc = IOCON_FUNC0 | IOCON_DIGITAL_EN | IOCON_SLEW_FAST},
        {.port = PIN_PIO_PORT, .pin = LED_RUNNING_PIN, .modefunc = IOCON_FUNC0 | IOCON_DIGITAL_EN | IOCON_SLEW_FAST},
        {.port = PIN_PIO_PORT, .pin = LED_SWD_PIN, .modefunc = IOCON_FUNC0 | IOCON_DIGITAL_EN | IOCON_SLEW_FAST},
        {.port = PIN_PIO_PORT, .pin = LED_JTAG_PIN, .modefunc = IOCON_FUNC0 | IOCON_DIGITAL_EN | IOCON_SLEW_FAST},
    };
    IOCON_SetPinMuxing(IOCON, kPinConfigs, ARRAY_SIZE(kPinConfigs));

    // 所有IO输入
    GPIO->DIRCLR[PIN_PIO_PORT] =
        PIN_TRST_MASK |
        PIN_TDI_MASK |
        PIN_TMS_MASK |
        PIN_TCK_MASK |
        PIN_RTCK_MASK |
        PIN_TDO_MASK |
        PIN_RESET_MASK;

    // 所有方向控制引脚输出
    GPIO->DIRSET[PIN_PIO_PORT] =
        PIN_TRST_DIR_MASK |
        PIN_TDI_DIR_MASK |
        PIN_TMS_DIR_MASK |
        PIN_TCK_DIR_MASK |
        PIN_RTCK_DIR_MASK |
        PIN_TDO_DIR_MASK |
        PIN_RESET_DIR_MASK |
        LED_CONNECTED_PIN_MASK |
        LED_RUNNING_PIN_MASK |
        LED_SWD_PIN_MASK |
        LED_JTAG_PIN_MASK;

    // 所有方向控制引脚拉低，全部输入
    GPIO->CLR[PIN_PIO_PORT] =
        PIN_TRST_DIR_MASK |
        PIN_TDI_DIR_MASK |
        PIN_TMS_DIR_MASK |
        PIN_TCK_DIR_MASK |
        PIN_RTCK_DIR_MASK |
        PIN_TDO_DIR_MASK |
        PIN_RESET_DIR_MASK;

    // 拉高灯灭
    GPIO->SET[PIN_PIO_PORT] =
        LED_CONNECTED_PIN_MASK |
        LED_RUNNING_PIN_MASK |
        LED_SWD_PIN_MASK |
        LED_JTAG_PIN_MASK;
}

/** Reset Target Device with custom specific I/O pin or command sequence.
This function allows the optional implementation of a device specific reset sequence.
It is called when the command \ref DAP_ResetTarget and is for example required
when a device needs a time-critical unlock sequence that enables the debug port.
\return 0 = no device specific reset sequence is implemented.\n
        1 = a device specific reset sequence is implemented.
*/
__STATIC_INLINE uint8_t RESET_TARGET(void)
{
    return (0U); // change to '1' when a device reset sequence is implemented
}

///@}

#endif /* __DAP_CONFIG_H__ */
